Please visit us at www.pdssoft.com for the latest information on this shareware software utility.
(Ordering information is also available on line.)
WinWizard Pro Version 2.0 R33
INSTALLATION:
Unzip the accompanying zip file using a standard "pkunzip" utility to a new folder for installation. Once the installation files are unzipped, run the SETUP.EXE and follow the on screen directions to complete the install.
USING THE APPLICATION:
The Status Window allows you to Open, Run, Pause and Stop a Script File. The Display Window is used to display user information for feedback during script processing. A script file may only be RUN from this window and MUST be saved in the editor prior to running.
The WinWizard Pro Editor allows you to create script files for processing. You may open and save script files here as well as writing them. When creating a new script file, the {EXIT} command will automatically be entered in the blank script file and you may begin editing from there.
Once command lines are entered into the Editor, you may Insert, Delete, Edit and Move the command lines. Double-Clicking on a line will display the Line Editor Window which will assist you in creating the command line, however, if you wish to edit the command line directly, you may click once on the line, then press the F2 key. This will allow you to edit a line using the standard editing features of Windows.
If you double-click on a line or press the "edit" button (or the "insert" button), the Command Line Editor will display allowing you to modify a line. You may select a command from the Script Command Drop Down List, all commands are located here and make it easy to create scripts.
The Parameters line is where the additional information from the command will be entered. In the example above, since the {DISPLAYADD} command was selected, the message to be displayed should be entered on the Parameter line. Commands such as {FLOAT} or {ACTIVATE} will present a list in the Parameter Drop Down List so writing script files becomes easier.
For Example: Selecting {FLOAT} from the Script Command Drop Down List will place "ON" and "OFF" in the Parameter Drop Down List. Therefore you need only select the Drop Down Button to finish the Command Line.
If {ACTIVATE} is selected, the Parameter Drop Down List will contain a list of all available processes so finishing the command is as easy as selecting from the list.
The "Browse" button may be utilized with commands such as {RUN} where a disk file name and path are required. When Browse is selected, a standard Windows Open Dialog box will appear and you may select the file name you wish to process. When you click "OK" in the Open Dialog Box, the file you selected will appear on the "Parameters" line.
Selecting the Variable List Drop Down Menu will allow you to select Variables to insert in your command line. Once the variable is selected, it will automatically be inserted into the Parameter Line. NOTE: If you use the ARROW keys to move from variable to variable, each one will be inserted onto the Parameter Line. The Variable Selection is best utilized with the mouse. Once your command line is finished, clicking the "OK" button will return you to the Editing Window and the current command line will correspond to your changes.
The WinWizard Pro Process Window allows you to display the available processes that are running, this may be used to find a process title when using the {ACTIVATE} command. This window will also display if the {PROCESS} command is encountered during script file execution. This may be useful for finding the process title of a program while you are testing your script file.
WinWizard Pro works by writing script or batch files utilizing the following series of commands. Each command line may only contain one command function and the command line must follow the appropriate syntax. Several "Sample" script files accompanied the WinWizard Pro download and may be used as a guide in creating your own script files.
This page is kept "up to date" with the most recent command reference structure. You may wish to print this page and retain it with your WinWizard Program. Also, check back here regularly for updates or modifications in the command structure.
Command Reference:
ACTIVATE
Syntax:
{ACTIVATE} ProcessTitle
Description:
Activates the designated Process so that keystrokes may be sent to it. ProcessTitle must match the Window Title Bar exactly for this command to work.
Example:
{ACTIVATE} Microsoft Word - Document1
The above example will activate the "Microsoft Word - Document1" window and prepare it so that the script file can send keystrokes to it.
Comments:
This command allows you the capability to control a program by sending keystrokes to it with the {TYPE} command. In some cases, the Program may automatically become active when you {RUN} it, in this event you may not need to use the {ACTIVATE} command.
AUTO
Syntax:
{AUTO} CheckInterval, ScriptFileName
Description:
Checks to see if the ScriptFileName exists in the proper Path every CheckInterval minutes. If the ScriptFileName exists, it will automatically be executed.
Example:
{AUTO} 5, c:\myfolder\testfile.wzd
The above example will automatically execute the "c:\myfolder\testfile.wzd" file when it is found on the system. It will check to see if this file exists every 5 minutes.
Comments:
This command is intended to allow a Systems Administrator to automatically update workstations by copying a file to a pre-designated location on the end user's hard drive or network drive. When the end user's computer sees the script file, it can automatically execute the script file. When the new script file is complete, the last command could delete the script file preventing it from starting again.
CALC
Syntax:
{CALC} Calculation
{CALC0} Calculation, {CALC1} Calculation, à {CALC9} Calculation
Description:
Performs a simple calculation and stores the results in {VARIABLE}. {CALC0-9} are stored in the values {VARIABLE0-9}.
Example:
{CALC} 10 + 10 + 10
The above example will calculate and store the result of 30 in the variable named {VARIABLE}
Comments:
Although this command will only perform simple calculations using "+", "-", "*" and "/" (Addition, Subtraction, Multiplication and Division) it can still be very useful to the script developer. You may also use VARIABLES in the calculation. The following command is valid and will store the result in {VARIABLE2}: {CALC2} {VARIABLE} + {VARIABLE3} * 100.
Note: The {CALC} and {CALC0-9} commands calculate from left to right only and you may not use parenthesis in your calculation.
CANCEL
Syntax:
{CANCEL} Message
Description:
Allows the end user to continue or cancel the script file execution.
Example:
{CANCEL} Would you like to continue running this script file?
The above example will display a dialog window allowing the user the option to continue or cancel the script. If the user selects the cancel button, the script file will end and no other options are allowed. If the user continues, the script will proceed from there.
Comments:
This command gives the end user a chance to abort a script file or simply allows the script file to wait for the end user to approve an operation. For example: {CANCEL} Insert a diskette in the floppy drive and select OK. This command will halt script execution until the end user is ready and selects the OK button.
CLIPAPPEND
Syntax:
{CLIPAPPEND} FileName
Description:
Appends, or adds, the contents of the clipboard to the existing FileName. The path must be included with FileName and only text information may be used.
Example:
{CLIPAPPEND} c:\data\clipdata.txt
In the above example, the contents of the clipboard will be added to the file c:\data\clipdata.txt.
Comments:
This command allows the clipboard to be added to an existing file. With this command, the script can continually save information to a file so that the resulting file will hold all of the information copied.
CLIPLOAD
Syntax:
{CLIPLOAD} FileName
Description:
Loads the contents of a file onto the clipboard. The path must be included with FileName and only text information may be used.
Example:
{CLIPLOAD} c:\data\testdata.txt
In the above example, the contents of the file c:\data\testdata.txt will be placed on the clipboard.
Comments:
This command allows you to place existing information onto the clipboard for "pasting" into an application or appending to another file with the CLIPAPPEND command.
CLIPSAVE
Syntax:
{CLIPSAVE} FileName
Description:
Saves the contents of the clipboard to a file. The path must be included with FileName and only text information may be used.
Example:
{CLIPSAVE} c:\data\clipdata.txt
In the above example, the contents of the clipboard are saved to the c:\data\clipdata.txt file.
Comments:
This command allows you to save the clipboard information for later use. Unlike the CLIPAPPEND command, the CLIPSAVE will erase any existing information in a file.
CLIPSET
Syntax:
{CLIPSET} TextString
Description:
Places the designated text information on the clipboard. Only text information may be used.
Example:
{CLIPSET} This report was started on {DATE} at {TIME}
In the above example, the clipboard will contain the data "This report was started on 11-25-1999 at 10:00:54" (the current date and time).
Comments:
With this and the other Clipboard commands you should be able to manipulate the clipboard to assist you in almost any clipboard handling script. The above example could be used to build a Log File of your script processes.
COPY
Syntax:
{COPY} SourceFile {TO} DestinationFile
Description:
Copies a file to a new name and/or location. Wildcards may NOT be used and the files must contain full paths.
The above example will copy the c:\autoexec.bat file to the c:\backup\autoexec.bat folder and file.
Comments:
Although you may elect to write a DOS Batch file to perform much of your copying needs, this command allows an easy way to incorporate it into your script files.
DISPLAY
Syntax:
{DISPLAY} Message
Description:
Displays a Message in the WinWizard Display Window, No Message will clear the display window.
Example:
{DISPLAY} This script file will install the Corporate Logo onto your system.
In this example, the display window of the WinWizard Program will display "This script file will install the Corporate Logo onto your system".
Comments:
This command allows you to give feedback to the end user. You can change the message as the script processes to show the current status of your script file.
DISPLAYADD
Syntax:
{DISPLAYADD} Message
Description:
Displays a Message in the WinWizard Display Window without clearing any previously displayed information.
Example:
{DISPLAYADD} This script will now copy some files to the Server.
In this example, the display window of the WinWizard Program will include the above message without erasing any other message in the display.
Comments:
This command allows you to display a list of information to the end user so that they may be able to see all of the steps which have completed in your script file. This may also be used to designate paragraphs in the display window since each new DISPLAYADD command starts on a new line.
DO
Syntax:
{DO} NumberOfLoops
Description:
Part of a DO/LOOP Command which creates a LOOP similar to the BASIC Programming Language. If you include NumberOfLoops, you will simulate a FOR/NEXT loop and the LOOP will cycle NumberOfLoops times.
Example:
{DO} 100
The example above will start a DO/LOOP which will cycle 100 times. Any command lines between the {DO} and {LOOP} will process for all cycles.
Comments:
The {DO} and {LOOP} commands allow you to repeat steps in a script file. You may use a variable in place of NumberOfLoops but unlike a BASIC FOR/NEXT command, the variable will not update as the loop continues. You would instead have to use a {CALC} command to keep track of the current cycle. (i.e. {CALC5} {VARIABLE5} + 1). If NumberOfLoops is omitted, the DO/LOOP Statement will cycle indefinitely or until an EXITDO statement is encountered.
END
Syntax:
{END}
Description:
Terminates the script file but does not close the WinWizard Program.
Example:
{END}
In the above example, the script file ends.
Comments:
The END command is used primarily during script development so that when the script file completes, the WinWizard Program will still stay open. Normally, you will wish to change the END command to an EXIT command once the script file is tested and ready for production.
ERASE
Syntax:
{ERASE} FileName
Description:
Erases the designated file from the designated path and drive. The file name and path are required for this command. You may NOT use wildcards in FileName.
Example:
{ERASE} c:\test\data\mytestdata.txt
In the above example, the c:\test\data\mytestdata.txt file will be deleted.
Comments:
As with the COPY Command, when erasing multiple files it may be more practical to create a DOS Batch file. However, this command allows an easy script method to perform a file delete.
EXIT
Syntax:
{EXIT}
Description:
Terminates a script file and closes the WinWizard Program.
Example:
{EXIT}
The above example causes the script file to terminate and closes the WinWizard Program.
Comments:
When WinWizard is processing a script file and it reaches the end of the script or the beginning of a sub-routine, WinWizard will automatically terminate the script and exit the program. However, the EXIT command was developed to primarily show "program flow" when reading and editing the script file. Whenever you begin a new script file using the built in script editor, the EXIT command will automatically be entered.
EXITDO
Syntax:
{EXITDO}
Description:
Causes script execution to exit a DO/LOOP statement.
Example:
{EXITDO}
In the above example, when the EXITDO statement is reached, it will end the previously assigned DO/LOOP cycle.
Comments:
Unless you are using the NumberOfLoops option in a DO/LOOP command, you may wish to exit the DO/LOOP statement should a certain condition be met. The EXITDO statement will override the NumberOfLoops option in the DO Command.
FLOAT
Syntax:
{FLOAT} On/Off
Description:
When turned on, causes the WinWizard Program to "float" on top of any other window in the display area even if it is not the active window.
Example:
{FLOAT} On
The above example turns the "windows on top" (float) option on.
Comments:
You may wish to use this command when displaying feedback to the end user through the DISPLAY and DISPLAYADD commands without having the information covered by any other applications. Using the FLOAT command while running the Windows Task Manager or other programs which "float" may cause system problems.
HOLD
Syntax:
{HOLD} ProcessTitle
Description:
Halts script execution until the designated ProcessTitle ends.
Example:
{HOLD} Microsoft Windows - Document1
The above example will halt script execution until the "Microsoft Windows - Document1" process terminates.
Comments:
The HOLD Command allows the script file to pause while a program may be running or exiting. Once the program is closed, the script will continue. The ProcessTitle may be other processes besides an actual Windows Program. You may check the Process List of the WinWizard Program to display the currently running processes that can be used in the HOLD Command.
IF
Syntax:
{IF} Condition {THEN} SubRoutine
Description:
Allows the script file to test for a certain Condition. If the Condition passes, the SubRoutine will be launched. The IF command is designed to test Text Character Strings.
Example:
{IF} {VARIABLE1} = Hello World {THEN} RunSayHello
In the above example, if the value of VARIABLE1 is equal to "Hello World", the RunSayHello sub-routine will begin processing. The sub-routine will return to the line following this IF Statement.
Comments:
The IF/THEN Statement allows you to check for certain conditions during script execution and act on them by redirecting the script to a sub-routine. When the sub-routine finishes, it returns to the line following the original IF Statement. The IF Command is primarily geared toward comparing for Text String values, the IFVAL, IFEXISTS and IFTASK commands may be used for other comparisons. The IF statement my ONLY result in a jump to a sub-routine (similar to a BASIC IF/THEN/GOSUB command).
Allows the script file to check if a certain file exists on the system. Based on the result of TRUE or FALSE, the SubRoutine may be launched. The IFEXISTS command is designed to check for disk files, drives and full paths should be included.
In the above example, the script file checks to see if the c:\autoexec.bat file exists. In this case, if it does not, the CreateAutoExecFile sub-routine is performed.
Comments:
The IFEXISTS command allows you to check for a disk file, you can then take action based on the results TRUE or FALSE. If the TRUE/FALSE condition is met, the sub-routine will be launched and script execution will continue on the line following this one when the sub-routine completes. The IF statement my ONLY result in a jump to a sub-routine (similar to a BASIC IF/THEN/GOSUB command).
Allows the script file to check if a certain process is active. Based on the result TRUE or FALSE, the SubRoutine may be launched.
Example:
{IFTASK} Microsoft Windows - Document1 = TRUE {THEN} TypeSomeText
In the above example, if the "Microsoft Windows - Document1" appears on the Process List, the TypeSomeText sub-routine will be launched.
Comments:
Similar to a HOLD or WAIT command, the IFTASK command allows you to take some action based on the condition of a certain process. A simple use of this command would be to check if a program is already running prior to running it. The IF statement my ONLY result in a jump to a sub-routine (similar to a BASIC IF/THEN/GOSUB command). The IFTASK command is designed to check the WinWizard Process List, you may therefore check for any of the items on this list which may not necessarily be Windows Program Titles.
IFVAL
Syntax:
{IFVAL} Condition {THEN} SubRoutine
Description:
Allows the script file to compare numeric values and act on the results. If the Condition passes, the SubRoutine will be launched.
In the above example, if the Value of VARIABLE5 is equal to the Value of VARIABLE6 then the DoTheSubRoutine will be launched.
Comments:
The IFVAL command is used only to compare numeric values. Even though the VARIABLE values may be text or numeric, the IFVAL command will convert any text it finds to a numeric value which will equal zero and will still try to perform the operation. The IF statement my ONLY result in jump to a sub-routine (similar to a BASIC IF/THEN/GOSUB command).
INPUT
Syntax:
{INPUT} Message
{INPUT0} Message, {INPUT1} Message à {INPUT9} Message
Description:
Halt script execution and allow the end user to input data. Message indicates the user prompt.
Example:
{INPUT} Enter your name belowà
In the above example, a dialog window will appear requesting the end user to "Enter your name belowà". When the user enters the information and clicks the OK button, the data will be stored in {VARIABLE} or {VARIABLE1-9} depending on the INPUT command.
Comments:
This command allows you to accept information from the end user and use it in your script processing. If the user selects the Cancel button, the variable will be null (no value).
LOOP
Syntax:
{LOOP}
Description:
Part of the DO/LOOP statement which indicates the end of the loop. Once this command is encountered, the script will return to the beginning DO line.
Example:
{LOOP}
The above example will cause script processing to resume at the statement following the original DO command.
Comments:
This command completes the DO/LOOP statement and will allow you to generate repeated steps in your script file. The LOOP can be exited using the EXITDO command or if the Number of Loops in the original DO statement have completed.
MINIMIZE
Syntax:
{MINIMIZE}
Description:
Minimizes the WinWizard window and places it on the task bar.
Example:
{MINIMIZE}
The above command minimizes the WinWizard window and places it in the "System Tray" identified by a lightning bolt. The end user may restore the window by double-clicking on the icon.
Comments:
This command is useful for allowing your script to process in the background or while it may be in a "wait state" such as when using the AUTO or START commands.
PAUSE
Syntax:
{PAUSE}
Description:
Halt script execution and wait for the user to press ENTER, the SPACE BAR or click the RUN button.
Example:
{PAUSE}
This example will pause the script file and wait until the user selects to continue. Since the RUN button is selected by default, the end user may press the ENTER key, the SPACE BAR or may click on the RUN button to continue the script.
Comments:
Occasionally you may wish to use this command during script testing or when you have displayed information in the WinWizard Display window and want to allow the end user time to review it. This command gives a similar result as the CANCEL command or SPLASH command.
PLAY
Syntax:
{PLAY} WaveFileName
Description:
Plays a .wav file on a multimedia system. The full drive and path should be included in WaveFileName.
Example:
{PLAY} c:\sounds\test.wav
In the above example, the wave file c:\sounds\test.wav will play on a multimedia system.
Comments:
The general concept of this command is to allow feedback to the end user. You may wish to record a message and play it to the end user versus displaying it on the screen. For example your wave file might be a talking voice saying "The first operation is completeà Moving to step 2".
PROCESS
Syntax:
{PROCESS}
Description:
Halt script execution and display the "On Line Process List".
Example:
{PROCESS}
The above example stops the currently running script file and displays the active processes in the WinWizard Process window.
Comments:
This command is primarily geared for script testing and finding active processes. You may use this command to find the Process Title of your screen saver. Create a script file that waits or SLEEPS for 5 minutes (or however long your screen saver takes to activate) then have the script file display the PROCESS list. You should then be able to identify the Process Title of your screen saver.
PROMPT
Syntax:
{PROMPT} Message
Description:
Halt script execution until the end user selects the OK button. Message may contain user feedback.
Example:
{PROMPT} Click OK when Readyà
In the above example, the script file displays a dialog window with the message "Click OK when Readyà" and will wait until the user clicks OK.
Comments:
Similar to the CANCEL command, the PROMPT command allows the end user to "catch up", however, it DOES NOT allow the user to cancel the script file.
REM
Syntax:
{REM} Remark
Description:
Add a Remark to the script file.
Example:
{REM} This portion of the Script will run the accounting program.
In this example, a remark or comment line is added to the script file for easier decryption of the script when changes need to be made in the future.
Comments:
Any REM statements encountered by the processing script file will be ignored. This command is only intended to place comments in your script file.
RENAME
Syntax:
{RENAME} OldFileName {TO} NewFileName
Description:
Rename a disk file. The drive and full path should be included with the OldFileName and NewFileName. No Wildcards may be used.
The above example renames the file c:\data\oldfile.txt to c:\data\newfile.txt.
Comments:
This command allows you to easily rename disk files through script processing. When renaming files, the complete drive and full path of both old and new file names should be included.
RESTORE
Syntax:
{RESTORE}
Description:
Restore the WinWizard window to its normal size.
Example:
{RESTORE}
This example returns the WinWizard window to its normal screen size from the minimized "System Tray" lightning bolt icon.
Comments:
This command may be used after a MINIMIZE command to restore the WinWizard window or may be used whenever you wish to ensure the window is visible for user feedback.
RETURN
Syntax:
{RETURN}
Description:
Returns script execution to the line following the calling statement.
Example:
{RETURN}
The above example returns script processing to the line following the calling IF statement.
Comments:
This command allows you to return processing to the calling statement. This would follow the same concept as a BASIC GOSUB/RETURN statement. This command is used at the end of a Sub-Routine.
RUN
Syntax:
{RUN} FileName
Description:
Load and run a windows application. The full drive and path should be included in FileName.
Example:
{RUN} c:\windows\wordpad.exe
In the above example, the WordPad program will be loaded and executed.
Comments:
This command allows you to launch a windows program and may usually be followed by the WAIT and ACTIVATE commands.
SCRIPT
Syntax:
{SCRIPT} ScriptFileName
Description:
Will load and run a new script file. The full drive and path should be included in the ScriptFileName.
Example:
{SCRIPT} c:\scripts\process2.txt
In the above example, the c:\scripts\process2.txt script file will be loaded and run through the WinWizard Program.
Comments:
This command allows you to "chain" script files together to create very large processes.
SET
Syntax:
{SET} Variable = Value
Description:
Sets the Value of a Variable: {VARIABLE}, {VARIABLE0}, {VARIABLE1}, à {VARIABLE9}
Example:
{SET} {VARIABLE5} = 125
In the above example, the VARIABLE5 is initialized to the value of 125.
Comments:
This command allows you to initialize variables in your script file for later use. Both numeric and string values may be used.
SHUTDOWN
Syntax:
{SHUTDOWN} Action
Description:
Will Shutdown, Restart or Reboot the end user personal computer. Where Action is equal to EXIT, RESTART or REBOOT.
Example:
{SHUTDOWN} EXIT
The above example will cause Windows to Shutdown and Exit.
Comments:
This command allows you to handle shutdown procedures through Windows. Caution should be used with this command, the end user may not be prompted to save all files prior to the shutdown.
SLEEP
Syntax:
{SLEEP} Seconds
Description:
Pause script execution for the designated number of Seconds.
Example:
{SLEEP} 5
In the example above, the script file will pause for 5 seconds.
Comments:
This command is useful when you which to wait for other processes to complete or want to give the user feedback without requiring them to click the mouse or press a key on the keyboard.
SPEED
Syntax:
{SPEED} ScriptSpeed
Description:
Defines how fast the script file executes between script commands, 1000 equals approx. 1 Second.
Example:
{SPEED} 2.5
In the example above, the script file will pause for approximately 2.5 seconds between each script command line it encounters.
Comments:
This command allows you to speed up or slow down your script file during processing. On slower PCs you may wish to slow the processing speed when sending keystrokes to a program, however, when you are doing internal script processing, you may wish for the script to process as quickly as possible. The lower the value of the script speed, the shorter the delay between command lines. Running a script file too quickly can cause keystrokes to be missed or ignored by the processing program.
SPLASH
Syntax:
{SPLASH} BitmapFileName
Description:
Display a graphic file splash screen with an OK and Cancel button. The full drive and path should be supplied in BitmapFileName.
Example:
{SPLASH} c:\graphics\splash.bmp
In the above example, a window will appear displaying the c:\graphics\splash.bmp graphic file with an OK and Cancel button toward the bottom right of the window and will wait for the end user to select one.
Comments:
This command is a custom version of the CANCEL command, it allows you to customize your script file by adding graphic displays to the end user. Your graphic file splash screen should direct the user to click OK or Cancel and, if the user selects Cancel, the script file will terminate.
START
Syntax:
{START} StartTime DayofWeek
Description:
Start Script Execution at the designated StartTime and DayOfWeek. StartTime must be entered as Military Time (HH:MM) and DayOfWeek must be MON,TUE,WED,THU,FRI,SAT,SUN,ALL.
Example:
{START} 08:00 MON,WED,FRI
In the above example, the script will begin processing on Monday, Wednesday or Friday at 8:00 am.
Comments:
This command allows you to process a script file on a regular daily or weekly schedule. You may not omit the StartTime option however, if DayOfWeek is omitted the script file will assume every day is desired. If you click on the PAUSE button while the script file is in this wait state, the script file will start immediately.
SUB
Syntax:
{SUB} SubRoutineName
Description:
Define a Sub-Routine within a script file.
Example:
{SUB} ProcessAccounts
In the above example, a sub-routine called "ProcessAccounts" has been defined and may be called by an IF statement.
Comments:
Since the IF, IFVAL, IFTASK and IFEXISTS statements can only call a sub-routine, the SUB command allows you the capability to define one. When the sub-routine is called, the script will begin the sub-routine on the line following the SUB command and will return to the calling IF statement when it encounters a RETURN command. Note: During normal script processing, if the script encounters a SUB command when it was not directed to it through an IF statement, the script will assume the file is complete and will terminate.
TITLE
Syntax:
{TITLE} NewTitleText
Description:
Change the WinWizard Title Bar Text
Example:
{TITLE} Process End of Day
In this example, the WinWizard title bar will change to "Process End of Day".
Comments:
Once again, this is another way to customize your script for the end user's feedback.
TYPE
Syntax:
{TYPE} KeyStrokes
Description:
Will send KeyStrokes to the active application.
Example:
{TYPE} Hello World {ENTER}
In this example, the phrase "Hello World" and the ENTER key are sent to the active application.
Comments:
This command allows you to send keystrokes directly to an application. The application must be active, normally accomplished through the ACTIVATE command. As with the previous version of WinWizard, you may omit the TYPE command and you would receive the same results (i.e. Hello World {ENTER}). The use of the TYPE command simply makes editing the script file more comprehendible.
WAIT
Syntax:
{WAIT} ProcessTitle
Description:
Halts script execution and waits for ProcessTitle to start before continuing on.
Example:
{WAIT} Untitled - Notepad
The above example will halt the script file until the "Untitled - Notepad" process appears on the process list, when it does, the script continues.
Comments:
The primary use of this command is to wait until a program is loaded before you send keystrokes to it. When you RUN an application, it may take a few seconds to load and this time may vary from computer to computer. With the WAIT command, the script will simply wait until the designated process is running, then you will be able to send keystrokes. Also, the ProcessTitle must match the program exactly.
Special Characters
The following characters are considered "Special Characters" to the WinWizard - Script Runner. If you wish to use these characters in your script, they must be enclosed in braces.
The following Special Key Codes allow you to send the specific "keystroke" to an application. These codes are generally associated used with the {TYPE} command.
{BACKSPACE} Send BACKSPACE Keystroke
{BKSP} Send BACKSPACE Keystroke
{BS} Send BACKSPACE Keystroke
{BREAK} Send BREAK Keystroke
{CAPSLOCK} Toggle CAPSLOCK on and off
{DELETE} Send DELETE Keystroke
{DEL} Send DELETE Keystroke
{DOWN} Send DOWN ARROW Keystroke
{END} Send END Keystroke
{ENTER} Send ENTER Keystroke
{ESC} Send ESCAPE Keystroke
{F1} through {F12} Send FUNCTION KEY Keystroke
{HOME} Send HOME Keystroke
{INSERT} Toggle INSERT mode on and off
{LEFT} Send LEFT ARROW Keystroke
{NUMLOCK} Toggle NUMLOCK on and off
{PGDN} Send PAGEDOWN Keystroke
{PGUP} Send PAGEUP Keystroke
{PRTSC} Send PRINT SCREEN Keystroke
{RIGHT} Send Right Arrow Key
{SCROLLLOCK} Toggle SCROLL LOCK on and off
{TAB} Send TAB Keystroke
{UP} Send UP ARROW Keystroke
Special Codes
~ Send ENTER Keystroke
+ Send SHIFT Keystroke
^ Send CTRL Keystroke
% Send ALT Keystroke
To specify key combinations such as SHIFT and E, enclose the code for those keys in parentheses. Example:
SHIFT-E = +(E)
CTRL-X = ^(X)
To repeat common keystrokes such as ARROW DOWN, include a number within braces. Example:
PRESS DOWN ARROW 5 TIMES = {DOWN 5}
PRESS THE 'N' KEY 10 TIMES = {N 10}
Note: WinWizard cannot control DOS application and using the {PRTSC} key may not always work.
Rules for Writing A Script File
All of the WinWizard Commands should appear on a single line, you cannot put multiple commands on a script line. Keystrokes, which are to be sent to an application, may be entered into the script normally.
WinWizard does not send an ENTER keystroke at the end of a line. If you wish to do this, you should enter the line as follows;
Enter Some Text into the Program {ENTER}
Multiple Special Key Codes may be placed on the same script line, Example;
%(E){DOWN 2}{ENTER}
The above line will activate the Copy option on an Edit Menu.
Special Characters should be enclosed in braces, for example to send the keystrokes;
